home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / dirc100.arc / DIRC_ENG.DOC < prev    next >
Text File  |  1991-09-17  |  11KB  |  306 lines
  1.  
  2.                                    August 1991
  3.                              ╔════════════════════╗
  4.                              ║ DIRC  version 1.00 ║
  5.                              ╟────────────────────╢
  6.                              ║ Ronnie van Schaijk ║
  7.                              ╚════════════════════╝
  8.  
  9.            >>>>      DIRC 1.00 is Public Domain Software      <<<<
  10.  
  11.  
  12.  
  13.  
  14.     DIRC version 1.00
  15.     -----------------
  16.  
  17.     With DIRC you can check EXEcute en COMmand files on their 
  18.     compression technique. First is was only mend to check the 
  19.     LZexe and PKlite compression, later on the compression technique
  20.     of EXEpack and the self-extracting files from the different
  21.     archive programs came along (for an update of the supported
  22.     exe/com compression techniques and the self-extracting programs,
  23.     see the versions list at the end). The last check is a check on 
  24.     the use of overlay-files. A lot of the execute files which uses 
  25.     overlays can't be compressed with PKlite and LZexe so that's
  26.     why this check is also available. Another added application is
  27.     that it recognizes files which are protected with EPW. The last
  28.     file check is a check on window or OS/2 files. Those files can
  29.     only run in the MS-windows or OS/2 environment and because of 
  30.     this exception those files can't be compressed.
  31.     
  32.  
  33.  
  34.     Used compression technique
  35.     --------------------------
  36.  
  37.     DIRC version 1.00 supports a lot of compression techniques. The 
  38.     following programs compress EXEcute and COMmand files so that they
  39.     can be executed (the programs are decompressed in memory).
  40.     (the version numbers are the versions which I used for testing,
  41.     for most the version before and perhaps the versions after
  42.     this one will also work along with DIRC 1.00)
  43.  
  44.     EXE & COM :    PKlite version 1.00 till 1.12, PKWARE Inc.
  45.             Diet version 1.00 till 1.10a, Teddy Matsumoto
  46.             Scrnch version 1.00 till 1.02, Greame W. McRae
  47.  
  48.     EXE      :    LZexe version 0.91, Fabrice BELLARD 
  49.             EXEpack, Microsoft
  50.             Pack, Turbo Power Software
  51.             Tinyprog, Tranzoa Co. 6/8/90 till 1/25/91 (version 3)
  52.  
  53.     COM       :    Shrink version 1.0, Thomas G. Hanlin III
  54.             Ice version 1.00, Keith P. Graham (this is not the
  55.             hack version of lharc but a whole different program)
  56.  
  57.  
  58.     Self-extracting archive programs
  59.     --------------------------------
  60.  
  61.     The following self-extracting files will be supported. 
  62.     (It is possible in very few cases that DIRC gives a false message 
  63.     indicating that some file is compressed with a archive-program 
  64.     while this files is not compressed with this program. This is because
  65.     DIRC searches through parts of the file to some strings.)
  66.  
  67.     EXE & COM :    LHARC version 1.13c, Haruyasu Yoshizaki
  68.             LARC version 3.33, K.MIKI H.OKUMURA K.MASUYAMA
  69.  
  70.     EXE      :    ARJ version 0.15 till 2.20, Robert K Jung
  71.             DWC version A5.01, Dean W. Cooper
  72.             HYPER version 2.5, P. Sawatzki K.P. Nischke
  73.             LH(A) version 2.05 till 2.12, Haruyasu Yoshizaki
  74.             PAK version 2.51, NoGate Consulting
  75.             PKXARC version 3.5, PKWARE Inc.
  76.             ARC version 6.02, System Enhancement Associates Inc.
  77.             PKZIP version 1.10, PKWARE Inc.
  78.             ZOO version 2.01, Rahul Dhesi
  79.  
  80.     COM      :    SCNRCH version 1.00, Greame W. McRae
  81.     
  82.     Password protection files
  83.     -------------------------
  84.  
  85.     DIRC checks EXEcute and COMmand files whether they are protected
  86.     with the program EPW. EPW protects files with a password which 
  87.     must be entered before the program can be run.
  88.     I have tested the program with EPW version 1.2, but it is probably
  89.     that dirc works fine with other versions of EPW. EPW version 1.2
  90.     is made by Alan D. Jones.
  91.  
  92.  
  93.     WINDOW and OS/2 files
  94.     ---------------------
  95.  
  96.     Because the MS-windows and OS/2 files can only be executed in the 
  97.     MS-windows or OS/2 environment, the files can't be compressed.
  98.     This is the reason why DIRC checks if an execute-file is a MS-windows
  99.     or OS/2 file.
  100.  
  101.  
  102.     HACKED files
  103.     ------------
  104.  
  105.     During the last few months several programs are seen with a so called
  106.     hacked (or rewritten) header. With this rewritten header the files 
  107.     can not be decompressed to its original and are a lot harder to
  108.     recognize. Examples are the files gus 1.40 (diet) and view 1.08 
  109.     (pklite). Those files won't be recognized by the compression program
  110.     either.
  111.     
  112.     
  113.     Necessary programs
  114.     ------------------
  115.  
  116.     DIRC works without any other program. Only for the option /V you
  117.     need to have some archive programs in your path. Are those archive
  118.     programs not in your path, than works the /V not for that particular
  119.     compression technique.
  120.  
  121.     for     ARC-exe        :    PAK.EXE
  122.         ARJ-exe     :    ARJ.EXE
  123.         HYP-exe     :    HYPER.EXE
  124.         LZH-exe/com and
  125.         LZS-exe/com :    LHARC.EXE or
  126.                 LHA.EXE (only for files which used LHA.EXE)
  127.         PAK-exe        :    PAK.EXE
  128.         ZIP-exe     :    PKUNZIP.EXE or
  129.                 PAK.EXE (version 2.50 or higher)
  130.  
  131.  
  132.     Options
  133.     -------
  134.  
  135.     DIRC has a few options so that only one specific compression 
  136.     technique will be checked. The following options can be used 
  137.     (every option must be preceded by a / )
  138.  
  139.         A    check the files not only for Diet, LZexe, PKlite
  140.             Shrink, Tinyprog and EXEpack compression techniques 
  141.             but check them also for self-extracting files. This 
  142.             option is not necessary for option /O or /V.
  143.  
  144.         B    for use of DIRC in batch files. With this option
  145.             there isn't any display on the screen but the 
  146.             program will return an exit-code. This exit-code can
  147.             be used in a batch-program (see exit-codes).
  148.  
  149.         C    check for a particular compression method. When there
  150.             is no character behind the C, only the files which
  151.             are compressed are selected. Behind the C the
  152.             following characters are possible:
  153.  
  154.             C    Scrnch            D    Diet            
  155.             E    exepack & pack        I    Ice
  156.             L    Lzexe            P    Pklite
  157.             S    Shrink            T    Tinyprog
  158.  
  159.             With the option CE the following programs will be
  160.             checked. The first is exepack from Microsoft and the
  161.             second is pack from Turbo Power Software.
  162.             For the PKlite files not only the normal and commercial
  163.             version is recognized, but also hacked versions (when
  164.             the pklite-line in the beginning of the file is over-
  165.             written) will be recognized. (With those files even 
  166.             pklite won't recognize the files anymore!)
  167.  
  168.         D    check not only the files in this directory,
  169.             but also the files in the sub-directories.
  170.  
  171.         H    show a short description of DIRC and the options.
  172.         
  173.         N    show only the files which are not compressed with
  174.             any (in this program known) compression technique.
  175.  
  176.         O    show those (self-extracting) files which are made 
  177.             with a archive program like ARJ, DWC, HYPER, LARC,
  178.             LHARC, PKARC, PAK, PKZIP, SCRNCH or ZOO.
  179.  
  180.         P    show only those files which are protected (with the
  181.             program EPW).
  182.  
  183.         RO    show the files which uses overlays.
  184.         RN    show the files which do NOT use overlays.
  185.  
  186.         T    calculate always the totals of all types of files. 
  187.             When this option is used at the end the totals of all
  188.             files are displayed. Only the number of overlay files 
  189.             is the real number of files which is displayed.
  190.  
  191.         V    show the files inside a self-extracting files from
  192.             ARC, ARJ, HYPER, LARC, LHARC, PAK and PKZIP (for this 
  193.             option some files must be available in the path).
  194.  
  195.         W    show only those files which must be executed in 
  196.             MS-windows or OS/2.
  197.  
  198.  
  199.     Exit-codes
  200.     ----------
  201.  
  202.     Whenever the option /B will be used, the following exit-codes are
  203.     important:
  204.              0    file not found
  205.              1    file is not an execute file (but has the 
  206.                 extension .EXE)
  207.              2    pklite file
  208.              3    arj-execute file
  209.              4    zip-execute file
  210.              5    lharc-execute/command file
  211.              6    pak-execute file
  212.              7    pkxarc-execute file
  213.              8    dwc-execute file
  214.              9    zoo-execute file
  215.             10    LZexe file
  216.             11    normal execute/command file
  217.             12    EXEpack file
  218.             13    larc-execute/command file
  219.             14    password protected file
  220.             15    diet file
  221.             16    hyper-execute file
  222.             17    lh(a)-execute file
  223.             18    tinyprog file
  224.             19    shrink file
  225.             20    ms-windows or OS/2 file
  226.             21    pack file
  227.             22    scrnch file
  228.             23    scrnch (self-extracting) file
  229.             24    ice file
  230.             25    pklite commercial file
  231.             26    pklite hacked file
  232.             27    diet hacked file
  233.             50    normal execute file with OVERLAYS
  234.     For an example about these exit-code you can look to the batch
  235.     files.
  236.  
  237.  
  238.  
  239.     For questions about DIRC
  240.     ------------------------
  241.  
  242.     Whenever there are questions or suggestions for DIRC, they can be
  243.     send by netmail towards the following bbs to Ronnie Van.Schaijk. 
  244.     The newest version of DIRC can also be found on this BBS.
  245.  
  246.     BBS:    The Gauntlet
  247.         telephone +31-73-569797
  248.         fido 2:512/37
  249.         modem speeds to HST/V32
  250.         sysop Jan.frederik Nipshagen
  251.         in the Netherlands
  252.  
  253.  
  254.  
  255.     Author: Ronnie van Schaijk
  256.         Oss (Netherlands)
  257.  
  258.  
  259.  
  260.     Versions
  261.     --------
  262.  
  263.     1.00 (27-AUG-1991)
  264.         - added the check for ARC (6.02) self-extracting files.
  265.         - added the /Total option.
  266.         - the exit-code for PKLITE is changed. There are different
  267.         exit-codes for the normal, commercial and hacked versions.
  268.         - the code to recognize ice files is added
  269.         - the newest version of tinyprog (version 3.00) is recognized
  270.         - an other version of exepack named pack from Turbo Power
  271.         Software is added
  272.         - the code to recognize the SCRNCH-files is added. Not only
  273.         the code to recognize compressed com-files but also the code
  274.         to recognize compressed text (or self-extracting) files is
  275.         added.
  276.         - a minor bug with arj.exe is solved
  277.         - the option /C_ is added in stead of the separate
  278.         options EILPST. Also is the option /W (password) changed 
  279.         to /P.
  280.         - the code to recognize the MS-windows or OS/2 files is
  281.         added (see option /W).
  282.     0.90 (29-APR-1991)
  283.         - the self-extracting file-code for LH(A) files is added
  284.         - the options /S and /T for the programs Shrink and Tiny-
  285.           prog are added.
  286.         - the check for ARJ-files is improved, the false alarms of
  287.         lzexe (arj 0.20) or diet (arj 1.00) are gone. The ARJ-exe
  288.         files made with version 2.00 will be recognized
  289.         - the newest diet 1.02b and pklite 1.05 will be recognized
  290.         by this (and newer) versions of DIRC
  291.     0.82 ( 3-FEB-1991)
  292.         - the option /B is added
  293.         - the archiver HYPER is added
  294.         - the name of the program is changed from dirx to DIRC
  295.         This is done to get rid of the confusion with other utils
  296.     0.81    - the compression technique diet is added
  297.     0.80 (16-JAN-1991)
  298.         - added the difference between the calculated en expected
  299.         number of bytes by files which use overlays
  300.         - the possibility to hold the scrolling by pressing any
  301.         key (except ESC)
  302.     0.79    - added the filesize of each file
  303.     0.78    - changed the code for ARJ version .20 self-extracting file
  304.     0.77    - first official version
  305.     0.75    - beta-version
  306.